home *** CD-ROM | disk | FTP | other *** search
/ Gigarom 1 / Gigarom Macintosh Archives (Quantum Leap)(CDRM1080320)(1993).iso / FILES / APP / E-L / Figger.sea / Figger™ Folder / Figger™ Documentation Part Two < prev    next >
Text File  |  1993-03-21  |  16KB  |  312 lines

  1. (Figger Reference, Part Two of Two)
  2.  
  3. V.    Menu Reference
  4.  
  5.   Apple Menu
  6.  
  7.       "About Figger…"
  8.           Displays the Figger "About Box" which contains some
  9.           information about the program.  This dialog also
  10.           contains a button for entering the program registration
  11.           area.
  12.  
  13.       ...desk accessories
  14.  
  15.   File Menu
  16.  
  17.       "Open"
  18.           Used to open an input file.  Brings up the open
  19.           dialog, described in the following chapter.
  20.  
  21.       "Close"
  22.           Closes the open file.  If the file has been
  23.           edited, a dialog will ask whether the data
  24.           should be saved.
  25.  
  26.       "Save As…"
  27.           Saves the open file.  If any Hide menu commands
  28.           have been used to hide data in the file, a FIG
  29.           file will be produced in addition to a GIF
  30.           file.
  31.  
  32.       "Quit"
  33.           Quits the program.  If there is an open file
  34.           that has been changed, a dialog will ask
  35.           whether the data should be saved.
  36.  
  37.   Edit Menu
  38.  
  39.       "Undo"
  40.           Undoes the preceding editing or hiding command.
  41.           This item is only available after such a
  42.           command has been issued.
  43.  
  44.       "Redo"
  45.           This command replaces "Undo" on the Edit menu
  46.           after an "Undo" command has been issued.  "Redo"
  47.           eliminates the effect of the preceding "Undo"
  48.  
  49.     "Cut","Copy","Paste"
  50.           These standard clipboard commands are not
  51.           supported by the current version of Figger, but
  52.           appear in the Edit menu so that the menu conforms
  53.           to accepted standards for the Edit menu.
  54.  
  55.       "Clear"
  56.           This standard editing command is not supported
  57.           by the current version of Figger, but appears
  58.           in the Edit menu so that the menu conforms to
  59.           accepted standards for the Edit menu.
  60.  
  61.       "Crop"
  62.           Permanently removes data outside of the current
  63.           selection rectangle from the image.  This data
  64.           is not saved for the FIG file.  This command
  65.           can be undone.
  66.  
  67.       "Show Clipboard"
  68.           Opens a window displaying the current contents
  69.           of the clipboard.  These contents are useless
  70.           within the current version of Figger.
  71.  
  72.   Hide Menu
  73.  
  74.       "Unlock"
  75.           Undoes any preceding "Hide Border," "Matte," or
  76.           "Blacken" commands.  This command can be undone.
  77.  
  78.       "Hide Border"
  79.           Removes any part of the image outside of the 
  80.           selection rectangle and saves it for inclusion
  81.           in the FIG file.  This command can be undone.
  82.  
  83.       "Blacken"
  84.           Fills the selection rectangle with black.
  85.           Any data which is obliterated is saved for
  86.           inclusion in the FIG file.  This command
  87.           can be undone.
  88.  
  89.       "Matte"
  90.           Fills any part of the image outside of the
  91.           selection rectangle with black.  Any data
  92.           which is obliterated is saved for inclusion
  93.           in the FIG file.  This command can be
  94.           undone.
  95.  
  96.   Display Menu
  97.  
  98.       "Normal Size"
  99.           Causes the image to be displayed on the monitor
  100.           at its actual size.
  101.  
  102.       "Zoom In"
  103.           Causes the image to be displayed on the monitor
  104.           at double the size it currently appears.  The
  105.           limit is 16 times the normal size.
  106.  
  107.       "Zoom Out"
  108.           Causes the image to be displayed at half the
  109.           size it currently appears.  The limit is
  110.           1/8 the normal size.
  111.  
  112. The "Open" command is available only if there isn't already an open file.  The "Close" command is available only if there is an open file.
  113.  
  114. The "Undo" command is available only after a command that changes the file has been issued.  (These commands include "Crop", "Unlock", "Hide Border", "Matte", and "Blacken".)
  115.  
  116. The "Redo" command is available only after an "Undo" command has been issued.
  117.  
  118. The "Crop," "Hide Border", "Matte", and "Blacken", commands are available only when a rectangle has been selected in the image.
  119.  
  120. The "Unlock" command is available once a "Hide Border", "Matte", or "Blacken" command has been issued.  Once the "Unlock" command has been issued, these other commands are forgotten, so the "Unlock" command then becomes unavailable.
  121.  
  122. The "Normal Size" command is available only when the image is not being displayed at its normal size.  The "Zoom In" command is available unless the image is being displayed at its maximum size (16 times).  The "Zoom Out" command is available unless the image is being displayed at its smallest size (one eighth).
  123.  
  124. VI.   Dialog Reference
  125.  
  126. •  File Dialogs
  127.  
  128. Most of the dialogs presented by Figger are used to select input and output files.  These dialogs are similar to the dialogs used for such purposes by almost every Macintosh application.
  129.  
  130. Certain elements appear in every file dialog.  These include the file list, a pop-up menu used to navigate through folders, and the "Eject", "Drive" ("Desktop" under System Seven), "Open" and "Cancel" buttons.
  131.  
  132. The dialogs used in Figger to select input files include additional controls that help in selecting exactly which files will be displayed in the file list.
  133.  
  134. These include a series of checkboxes that determine which file attributes will be considered in selecting the files for the list.  These checkboxes include:
  135.  
  136.     •   Check File Type
  137.  
  138.         On the Macintosh, every file has an associated type, which
  139.         is why double-clicking on a particular file in a Finder
  140.         window will result in the correct program being started
  141.         to handle the file.
  142.  
  143.         When this checkbox is checked, only files having the
  144.         proper file type will be displayed.
  145.  
  146.         Note that files created on non-Macintosh systems will
  147.         not have a file type.  Also, if a file is created using
  148.         a Macintosh and then moved to another type of system,
  149.         the file type will be lost.  Such files will not
  150.         appear in the file list if this checkbox is checked.
  151.  
  152.     •   Check Extension
  153.  
  154.         By convention, GIF files frequently have names that
  155.         consist of one to eight alphanumeric characters
  156.         followed by the extension ".GIF".  A similar convention
  157.         for key (FIG) files, in which the extension is ".FIG",
  158.         is being encouraged.
  159.  
  160.         When this checkbox is checked, only files whose names
  161.         end with the appropriate extension will be listed.
  162.  
  163.     •   Check Contents
  164.  
  165.         Both GIF and FIG files contain internal information
  166.         that can be used to determine that they are a GIF
  167.         or FIG file.  When this checkbox is checked, files that
  168.         do not contain the appropriate information will not be
  169.         listed.
  170.  
  171.         Note that this might prove to be a time-consuming
  172.         process, as a large number of files might have to
  173.         be read.
  174.  
  175. The effect of the various checkboxes is cumulative: if more than one of the boxes is checked, only files that meet all checked criteria will be listed.  If none of the checkboxes is checked, then all files in the particular folder or directory will be listed.
  176.  
  177. These filtering criteria do not affect whether folders are listed in the file list.  Folders are always listed.
  178.  
  179. The following discussions cover details about the various file dialogs presented by Figger.
  180.  
  181.   -- Open File Dialog
  182.  
  183.      This dialog is presented when you select "Open" from the File
  184.      menu.  It allows you to select an input file.
  185.  
  186.      Both GIF and FIG files will be displayed.  If you select a GIF
  187.      file, then the file will be opened and you will be able to edit
  188.      it using Figger.  If, instead, you select a FIG file, you will
  189.      begin the process of joining a GIF/FIG combination into a
  190.      restored GIF file.
  191.  
  192.      This dialog contains the checkboxes for narrowing down which
  193.      files are displayed.  By default, the "Check File Type" box is
  194.      checked.  This means that the only files that will be displayed
  195.      will be those with the correct Macintosh file type.
  196.  
  197.      An additional set of radio buttons allows you to determine whether
  198.      only GIF, only FIG, or both GIF and FIG files will be displayed.
  199.      By default, both types of files will be displayed.
  200.  
  201.   -- Select GIF File Dialog
  202.  
  203.      This dialog is presented after you select a FIG file from the
  204.      Open File Dialog.
  205.  
  206.      Its purpose is to allow you to select the GIF file to be
  207.      combined with the FIG file.  Note that if you select a GIF
  208.      file that was not created in tandem with the FIG file, an
  209.      error will occur.
  210.  
  211.      Near the top of the dialog is the "suggested name."  This
  212.      is the name of the GIF file that was created at the same
  213.      time as the FIG file.  This information was stored inside
  214.      the FIG file.  There is nothing to prevent people who own
  215.      or distribute the GIF file from changing the name of the file,
  216.      so it is possible that the displayed name will not be the
  217.      name of the copy of the file that you have.  Hopefully,
  218.      people will make things easy for others by maintaining the
  219.      same name for the file.
  220.  
  221.      This dialog has one additional checkbox, "Match Name," which
  222.      is initially checked.  This means that only files that have
  223.      a name which matches the suggested name will be displayed.
  224.      This option has a cumulative effect with those of the other
  225.      checkboxes.
  226.  
  227.      If you press the "Cancel" button, the FIG file will be closed
  228.      and the process of opening a file will end.
  229.  
  230.   -- Save File Dialog
  231.  
  232.      After you select a GIF file, you will be presented with a
  233.      dialog where you can enter the name of the new GIF file to
  234.      be produced.
  235.  
  236.      When you select the "Save As" item from the File menu, you
  237.      will be presented with this dialog.  You can then choose a
  238.      name and location for the GIF file that you are producing.
  239.  
  240.      Although you can use the same name and location as those of
  241.      the input GIF file, this action is discouraged, because it
  242.      means that the original GIF file will be deleted.
  243.  
  244.      If you press the "Cancel" button, the process of saving the
  245.      file will end and you can return to editing the image.
  246.  
  247.   -- Save FIG File Dialog
  248.  
  249.      After you specify the name of the output GIF file, you will
  250.      be presented with a dialog where you can specify the name and
  251.      location of the associated key "FIG" file.
  252.  
  253.      If you had given the GIF file a conventional name, (including
  254.      the ".GIF" extension), the name box will be filled in with
  255.      the same name as the GIF file, with a ".FIG" extension.  It
  256.      is suggested that you follow this convention and use this
  257.      name.
  258.  
  259. •  The "About Box"
  260.  
  261. The About Box appears when you start Figger as well as when you select "About Figger…" from the Apple menu.  Its purpose is simply to display information about the program, including required copyright notices.
  262.  
  263. As you start the program, the About Box will appear without any visible buttons.  During this time, the program will be going through its own initialization.  Eventually, two buttons will appear in the lower right-hand corner of the box.
  264.  
  265. Press the "Okay" button to dismiss the About Box.
  266.  
  267. The "Register" button brings up the registration dialog, which is discussed later in this document.
  268.  
  269. Note that if your copy of Figger has not been given a proper registration number, the About Box will not disappear automatically after the program has initialized.  Once the registration process has been completed, then each time you start Figger the About Box will disappear as soon as program initialization has completed.
  270.  
  271. VII.  File Naming Conventions
  272.  
  273. Because GIF files are exchanged among various types of computer systems, a naming convention has been adopted which allows the same name to be used for a particular file no matter where the file is being stored.  The name consists of one to eight alphanumeric characters, (the first character must be a letter), followed by the extension ".GIF".
  274.  
  275. Even though the Macintosh provides quite robust file naming capabilities, Mac owners have usually followed the short naming convention if they are exchanging GIF files with users of other types of computers.
  276.  
  277. It is suggested that in order to facilitate the exchange of FIG files across different types of systems, a similar naming convention be used, in which the extension is ".FIG".  Also, to simplify the task of matching FIG files to GIF files, it is suggested that the main part of the name (the first one to eight characters) be the same for both files.
  278.  
  279. Files may be renamed after they are created.  However, it is suggested that the file names be retained as long as the files are in circulation, so that the proper GIF/FIG combination may be located by anyone interested.  When a file combination is initially created, the name of the GIF file is stored inside the FIG file.  Renaming the GIF file would render this information useless, and complicate the process of locating proper GIF/FIG combinations.
  280.  
  281. Note that the word "GIF" is pronounced with a "soft G", i.e., "jif".  In a similar manner, "FIG" is pronounced "fidge," "Figger" is pronounced "fidger," and "DisFigger" is pronounced "diz-fidger."
  282.  
  283. VIII. The "Figger Mark"
  284.  
  285. When Figger creates a GIF file that has an associated key or "FIG" file, it places a tiny "F" in the lower right-hand corner of the GIF image.  This serves the sole purpose of letting anyone who views the image know that a key file is available for the image.
  286.  
  287. When the key file is combined with the GIF file, the "F" will be removed, since it no longer has meaning.
  288.  
  289. This mark is _not_ meant as a tool to enforce registration of the product.  It is produced by both registered and unregistered copies of Figger.
  290.  
  291. IX.   Registration
  292.  
  293. Registration of this product offers several benefits, including a formatted printed copy of the documentation, a copy of the latest version of the program, and support.  For details on registration, see the registration form that is distributed with this package.
  294.  
  295. This section describes the Figger functions related to registration.  There are two such functions.  The first allows you to create a copy of the registration form, just in case you have lost the form that came with this package.  The second allows you to enter the registration number that you receive when you receive your registered copy of the program.
  296.  
  297. To perform either of these functions, you must first display the "About Box."  The easiest way to do this is to select "About Figger…" from the Apple menu.  Next, press the "Register" button located in the lower right-hand corner.  This will bring up a dialog that gives a short description of the registration process.
  298.  
  299. If you press the "Create Form" button in this dialog, you will be presented with a standard file-saving dialog in which you are asked to provide a name and location for the text file that is about to be created.  After you specify these items and press the "Save" button, the form will be created.  This form may be read using any standard word processor that accepts text format files, (including TeachText).
  300.  
  301. You may print the registration form using a word processor, fill it in, and mail it to Daly Associates to register your copy of Figger.  When you receive your registered copy of the program, you will receive a unique registration number.
  302.  
  303. The second function of the registration dialog is to allow you to enter your registration number.  Once you have done this, the About Box will disappear automatically after you have started Figger, rather than requiring you to press the "Okay" button to dismiss it.
  304.  
  305. To enter your registration number, bring up the registration dialog by pressing the "Register" button in the About Box.  Type the registration number and press "Okay".
  306.  
  307. The registration number is stored in a special file named "Figger™.PREF", which is used to maintain information that Figger uses from one execution to the next.  This file is stored in your system folder.  (Under System Seven, it is stored in your Preferences folder within your System folder.)  If you want to move your copy of Figger to a different machine, you might want to move the Figger™.PREF file along with it.
  308.  
  309. If you give away a copy of Figger to a friend, don't bother giving them the Figger™.PREF file, as it contains information that is pertinent only when you personally are using the program.
  310.  
  311.  
  312.